home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / MPI_Allgatherv.z / MPI_Allgatherv
Encoding:
Text File  |  2002-10-03  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. MMMMPPPPIIII____AAAALLLLLLLLGGGGAAAATTTTHHHHEEEERRRRVVVV((((3333))))                                            MMMMPPPPIIII____AAAALLLLLLLLGGGGAAAATTTTHHHHEEEERRRRVVVV((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      MMMMPPPPIIII____AAAAllllllllggggaaaatttthhhheeeerrrrvvvv - Gathers data from all tasks and delivers it
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      C:
  13.  
  14.           #include <mpi.h>
  15.  
  16.           int MPI_Allgatherv ( _s_e_n_d_b_u_f, _s_e_n_d_c_o_u_n_t,  _s_e_n_d_t_y_p_e,
  17.           _r_e_c_v_b_u_f, _r_e_c_v_c_o_u_n_t_s, _d_i_s_p_l_s,
  18.           _r_e_c_v_t_y_p_e, _c_o_m_m )
  19.           void             *_s_e_n_d_b_u_f;
  20.           int               _s_e_n_d_c_o_u_n_t;
  21.           MPI_Datatype      _s_e_n_d_t_y_p_e;
  22.           void             *_r_e_c_v_b_u_f;
  23.           int              *_r_e_c_v_c_o_u_n_t_s;
  24.           int              *_d_i_s_p_l_s;
  25.           MPI_Datatype      _r_e_c_v_t_y_p_e;
  26.           MPI_Comm          _c_o_m_m;
  27.  
  28.  
  29.      C++:
  30.  
  31.           #include <mpi.h>
  32.  
  33.           void Intracomm::Allgatherv(
  34.           const void*       _s_e_n_d_b_u_f,
  35.           int               _s_e_n_d_c_o_u_n_t,
  36.           const Datatype&   _s_e_n_d_t_y_p_e,
  37.           void*             _r_e_c_v_b_u_f,
  38.           const int         _r_e_c_v_c_o_u_n_t_s[],
  39.           const int         _d_i_s_p_l_s[],
  40.           const Datatype&   _r_e_c_v_t_y_p_e) const
  41.  
  42.  
  43.      Fortran:
  44.  
  45.           INCLUDE "mpif.h" (or USE MPI)
  46.  
  47.           <type> SENDBUF(*), RECVBUF(*)
  48.           INTEGER _s_e_n_d_c_o_u_n_t, _s_e_n_d_t_y_p_e, _r_e_c_v_c_o_u_n_t_s(*), _d_i_s_p_l_s(*),
  49.           _r_e_c_v_t_y_p_e, _c_o_m_m, _i_e_r_r_o_r
  50.  
  51.           CALL MPI_ALLGATHERV(_s_e_n_d_b_u_f, _s_e_n_d_c_o_u_n_t, _s_e_n_d_t_y_p_e,
  52.           _r_e_c_v_b_u_f, _r_e_c_v_c_o_u_n_t_s(*), _d_i_s_p_l_s(*), _r_e_c_v_t_y_p_e,
  53.           _c_o_m_m, _i_e_r_r_o_r)
  54.  
  55.  
  56. SSSSTTTTAAAANNNNDDDDAAAARRRRDDDDSSSS
  57.      This release implements the MPI 1.2 standard, as documented by the MPI
  58.      Forum in the spring 1997 release of _M_P_I:  _A _M_e_s_s_a_g_e _P_a_s_s_i_n_g _I_n_t_e_r_f_a_c_e
  59.      _S_t_a_n_d_a_r_d.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MMMMPPPPIIII____AAAALLLLLLLLGGGGAAAATTTTHHHHEEEERRRRVVVV((((3333))))                                            MMMMPPPPIIII____AAAALLLLLLLLGGGGAAAATTTTHHHHEEEERRRRVVVV((((3333))))
  71.  
  72.  
  73.  
  74. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  75.      The MMMMPPPPIIII____AAAAllllllllggggaaaatttthhhheeeerrrrvvvv routine gathers data from all tasks and delivers it to
  76.      all.  This routine accepts the following parameters:
  77.  
  78.      _s_e_n_d_b_u_f        Specifies the starting address of the send buffer
  79.                     (choice).
  80.  
  81.      _s_e_n_d_c_o_u_n_t      Specifies the number of elements in the send buffer
  82.                     (integer).
  83.  
  84.      _s_e_n_d_t_y_p_e       Specifies the data type of the send buffer elements
  85.                     (handle).
  86.  
  87.      _r_e_c_v_c_o_u_n_t_s     Specifies the integer array (of length _g_r_o_u_p _s_i_z_e,
  88.                     specified in _c_o_m_m) containing the number of elements that
  89.                     are received from each process.
  90.  
  91.      _d_i_s_p_l_s         Specifies the integer array (of length _g_r_o_u_p _s_i_z_e,
  92.                     specified in _c_o_m_m). Entry _i specifies the displacement
  93.                     (relative to _r_e_c_v_b_u_f ) at which to place the incoming data
  94.                     from process _i.
  95.  
  96.      _r_e_c_v_t_y_p_e       Specifies the data type of the receive buffer elements
  97.                     (handle).
  98.  
  99.      _c_o_m_m           Specifies the communicator (handle).
  100.  
  101.      _r_e_c_v_b_u_f        Returns the address of the receive buffer (choice).
  102.  
  103.      _i_e_r_r_o_r         Specifies the return code value for successful completion,
  104.                     which is in MPI_SUCCESS.  MPI_SUCCESS is defined in the
  105.                     mmmmppppiiiiffff....hhhh file.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.